函数名称:SeasLog::setRequestVariable()
适用版本:SeasLog 2.0.0及以上版本 函数描述:设置请求变量,用于在日志中记录请求相关的信息。
用法:
bool SeasLog::setRequestVariable(string $key, mixed $value)
参数:
$key
:请求变量的键名,类型为字符串。$value
:请求变量的值,可以是任意类型的值。
返回值:
- 如果设置成功,返回布尔值
true
。 - 如果设置失败,返回布尔值
false
。
示例:
<?php
// 设置请求变量
SeasLog::setRequestVariable('user_id', 123);
SeasLog::setRequestVariable('username', 'john_doe');
// 记录日志
SeasLog::info('User logged in');
// 设置多个请求变量
$data = [
'ip' => '127.0.0.1',
'referer' => 'https://example.com',
'user_agent' => $_SERVER['HTTP_USER_AGENT']
];
foreach ($data as $key => $value) {
SeasLog::setRequestVariable($key, $value);
}
// 记录日志
SeasLog::info('User performed an action');
// 清除请求变量
SeasLog::setRequestVariable('user_id', null);
SeasLog::setRequestVariable('username', null);
SeasLog::setRequestVariable('ip', null);
SeasLog::setRequestVariable('referer', null);
SeasLog::setRequestVariable('user_agent', null);
?>
注意事项:
- 通过
SeasLog::setRequestVariable()
设置的请求变量仅在当前请求的生命周期内有效。 - 请求变量会被记录在每条日志中,可以用于追踪和调试。
- 可以使用
SeasLog::getRequestVariable()
函数获取已设置的请求变量的值。